home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu317.dms / pu317.adf / PUBLIC / BBS / BasicProgs / Morse / DXTest / DXTEST.DOC < prev   
Text File  |  1990-06-01  |  5KB  |  119 lines
  1. DXTEST.BAS
  2. Original program by Clarke Greene K1JX
  3. Amiga version by John Gager K7KB
  4.  
  5. [See bug report at end of this file.]
  6.  
  7. This ARC contains the Microsoft BASIC (tm) source code for the ARRL DX Test
  8. log editing program listed in the "Contests" chapter of The ARRL Operating
  9. Manual, Third Edition.  The program takes an ASCII log listing (as created by
  10. you with your favorite word processor), and produces a log package suitable
  11. for submission to the contest sponsor. Three separate files are produced:
  12.  
  13.     1. A LOG file - (identified by the filename extension ".LOG").  This file
  14.        holds the actual log.  New multipliers (countries) are identified and
  15.        counted, and duplicate contacts identified.
  16.  
  17.     2. A DUPE SHEET file - (identified by the filename extension ".DUP"). This
  18.        file holds a dupe sheet as required by the contest sponsors.  This is a
  19.        complete listing of all the  contacts made on a particular band, in
  20.        alphabetical order.
  21.  
  22.     3. A SUMMARY file - (identified by the filename extension ".SUM"). This
  23.        file holds a summary sheet for the band edited. Total valid QSOs,
  24.        duplicate QSOs, total QSO points, and countries worked are listed as
  25.        well as a complete breakdown of QSOs per country.
  26.        
  27. The file containing the log entries must be an ASCII file in the 
  28. following format:
  29.  
  30.     TIME      CALLSIGN      RCV'D REPORT
  31.  
  32. At least one space must be between each field of each log entry, and each line
  33. must be terminated by a carriage return. Only a changed digit in the time
  34. field must be present; for example, if the contest begins at 1800Z and the
  35. first contact is made at 1802Z and the second contact is made at 1805Z, then
  36. only 5 need be entered in the time field. If the third contact is made at 
  37. 1812Z, then 12 should be entered in the time field. If the next contact is
  38. made at 1812Z, then no number need be entered in the time field (however, be
  39. sure to enter a space to indicate separation between fields). If no signal
  40. report is entered as part of the received report, 59(9) (depending on the
  41. mode) is assumed.
  42.  
  43. The three output files (.LOG, .DUP, and .SUM files) can be printed by using
  44. the Amiga "TYPE" command.
  45.  
  46. Some reminders:
  47.  
  48. 1. Be sure your log is in an ASCII format. Just about every word processor can
  49.    operate in an ASCII or Non-Document mode - that should work fine.  As an
  50.    alternative, you can use one of the many utilities available in the
  51.    marketplace and in the public domain to convert your word processor output
  52.    into an ASCII format.
  53.  
  54. 2. If you enter the callsigns in your log in lowercase, they are automatically
  55.    converted to uppercase for the final .LOG file. 
  56.  
  57. 3. Since you probably will copy this program onto a working disc (rather than
  58.    suffer the usual consequences of Mr. Murphy), remember that DXTEST needs
  59.    access to DXPREFIX.LIB.  DXPREFIX.LIB must be on the same disc as this
  60.    program, and in the root or main directory of your disk.
  61.  
  62. 4. Each band requires a separate entry file. The output files will be named as
  63.    the original filname plus the appropriate extension (for example DXCW15.LOG,
  64.    DXCW15.DUP, and DXCW15.SUM would be produced from the log entry file
  65.    DXCW15.) As a consequence of this, any file with the same name will be 
  66.    overwritten when DXTEST is run.  To avoid any deletion of valid files, use
  67.    unique names for the files used on each band, and don't use the extensions
  68.    .LOG, .DUP, or .SUM.
  69.  
  70. Special notes for the Amiga version
  71. -----------------------------------
  72.  
  73. This ARC contains 4 files:
  74.  
  75. DXTEST.BAS  -  AmigaBasic program
  76.  
  77. DXTEST.DOC  -  This documentation file
  78.  
  79. DXTEST.DAT  -  A small example log file used to show example log entrys and
  80.                to test the DXTEST.BAS program.
  81.  
  82. DXPREFIX.LIB - A listing of DX prefixes and countries used by this program.
  83.    
  84.   To give credit where credit is due, this program is by Clarke Greene K1JX.
  85. The only thing I've done is go through his program and make it more agreeable
  86. with AmigaBasic, and add a few minor features along the way. I really haven't
  87. had a chance to test this program throughly since I don't get into contesting
  88. very much, but I believe it is free of any major bugs. If you find any bugs
  89. that I have missed, or have suggestions and comments about these programs,
  90. please let me know.
  91.  
  92.   One thing you will notice about these programs is that they are slow!! For
  93. example, I wrote a program that created a log using random prefixes from the
  94. DXPREFIX.LIB file. It created a log of 1439 entries, and the IARULOG.BAS
  95. program took about 1 1/2 hours to process the log! So patience is certainly a
  96. virtue when processing a large log. Although it would have been nice to
  97. compile these programs since I have the Absoft basic compiler, after I ran
  98. the compiled version of IARULOG on the same fake log, it took over 3 hours
  99. to process it! In some defense of Absoft, the MiniMuf program I wrote runs
  100. considerably faster compiled.
  101.  
  102. 73,
  103.  
  104. John Gager K7KB
  105. CompuServe ID 71336,624
  106.  
  107. Bug report:
  108.  
  109. 1. Expanded DXPREFIX.LIB memory allocation for bigger library.
  110.  
  111. Amiga features include:
  112.  
  113.  * Automatic capitalizing of entries read from log source file.
  114.  
  115.  * Automatic capitalizing of keyboard entries from program prompts.
  116.  
  117.  * Expanded error checking for improper data read both from the log
  118.    source file and the keyboard.
  119.